home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4 / Atari Forever 4.iso / SERIE_AI / AI_074 / MPLYR215 / MPLYR_EN.DOC < prev    next >
Encoding:
Text File  |  1998-03-14  |  15.5 KB  |  459 lines
  1. (set TAB to 8 caracters to get the original display)
  2.  
  3. *************************************************************
  4. WARNING: Res-change on the Falcon, see at the end of this DOC
  5. *************************************************************
  6. WARNING: TT without graphic card, see at the end of this DOC
  7. *************************************************************
  8.  
  9. TELLO Guillaume
  10. 240 rue Estienvrin
  11. 49260 Montreuil Bellay
  12. FRANCE
  13.  
  14. Email: gtello@planete.net
  15.  
  16. Download M_PLAYER from http://www.tripnet.se/~mille (Thanks Mille!)
  17.  
  18.  
  19. ****************************************************************************
  20.         M_PLAYER.PRG DOCUMENTATION Version 2.15β
  21.          (Thank you Dave for your correction!)
  22. ****************************************************************************
  23.  
  24.  
  25.          It's a Quick Time and AVI player with sound,
  26.          and a FLI/FLC/FLH, SEQ, PI1+DLT, FLM player.
  27.           It can also CREATE Quick Time files (Images & sound)
  28.  
  29. ********** Shareware ****************
  30.  
  31.     If you want to register, please send 15DM, CAN$15, US$10, 60F or
  32. 7UKP to me or to my bank:
  33.     Crédit Agricole Anjou Mayenne/49000 Angers (France)
  34.     Account n°10434852000
  35.  
  36.     North America User, you can register (US$10) at:
  37.  
  38.     Nima Montaser          Hardware and Software Specialists
  39.     Homa Systems House       ATARI Graphics and Multimedia
  40.        P.O. Box 52127          nima@magmacom.com
  41.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  42.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  43.                URL: http://www.magmacom.com/~nima
  44.  
  45.  
  46.         G E N E R A L   C O N S I D E R A T I O N S
  47.         *******************************************
  48.  
  49. Capabilities:
  50. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  51.     Can create Quick Time movies from a serie of images (and an
  52. optional sound), images formats are:
  53.         - TGA2 16 or 24 bits (to RLE16 compression)
  54.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  55.     Sound formats are:
  56.         - AVR, 8/16 bits, mono/stereo
  57.         - WAV, 8/16 bits, mono/stereo
  58.     (see below BATCH files, and SLIDSHOW.DOC)
  59.  
  60.     Can play eight types of animations:
  61.     - *.MOV (Quick Time)
  62.         - graphics with:
  63.             CVID (compressed yuv)
  64.             RLE8 (grey or col), RLE16, RLE24, RLE32
  65.             SMC8
  66.             RAW1, RAW2 (grey or col), RAW4 (grey or col)
  67.             RAW8 (grey or col), RAW16, RAW24, RAW32
  68.             RPZA (15 bits)
  69.             YUV2, YUV9, YVU9 (uncompressed yuv)
  70.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  71.         - switch for image-sound synchronisation
  72.         - switch for sound
  73.     - *.AVI (Video for Windows)
  74.         - graphics with:
  75.             CVID
  76.             CRAM16, CRAM8
  77.             MSVC16, MSVC8
  78.             RLE8
  79.             RGB8
  80.             YUV9, YVU9
  81.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  82.         - switch for image-sound synchronisation
  83.         - switch for sound
  84.  
  85.     - *.FLI/FLC/FLH (Autodesk Animator)
  86.     - *.SEQ        (Cyber Paint)
  87.     - *.PI1 + *.DLT    (Cyber)
  88.     - *.FLM        (Kinetic Microsystems)
  89.     - *.FLM        (Lexicor, anims ST Low only)
  90.         - graphics only
  91.         - normal speed or maxi speed
  92.         - loop mode (Shift key)
  93.         (for PI1 + DLT, you must select the PI1 file, then the DLT
  94.         file must share the same name and be located into the same
  95.         directory: c:\EXAMPLE.PI1 and c:\EXAMPLE.DLT)
  96.  
  97.     - step by step mode
  98.         - every frame displayed (auto or not)
  99.         - can save this frame into a TGA file (auto or not)
  100.         - doesn't work with NOVA or TT 256 colors
  101.  
  102.     - *.BAT (Batch files for slideshow):
  103.         - simple language to load and display a serie of images
  104.         - image format:
  105.             TGA 2 uncompressed (your POV creations for example)
  106.             IMG ('XIMG' and 256 colors)
  107.         more formats will be added in the furture
  108.         (see SLIDSHOW.DOC)
  109.  
  110.  
  111. Hardware requiered:
  112. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  113.     - TT + NOVA, High Color (32768 colors) or 256 colors and plenty
  114.         of RAM.
  115.     - TT + Crazy Dots 2, same as above
  116.     - TT without graphic card (256 colors)
  117.     - Falcon, True Color (32768 colors) and plenty of RAM (Outside
  118.     accepted! Afterburner 040, ScreenBlaster, Blow up,
  119.     Centurbo I)
  120.     - PowerBook with MagicMac (but the sound...)
  121.  
  122.  
  123. Damn!, I've got 16Mb of TT RAM, and DMA sound can't be played from it!
  124. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  125.  
  126.     Well, you should set the 'TT Load' and 'TT Malloc' flags of the
  127. program to keep the largest possible amount of ST RAM free. TT RAM is then
  128. used to load the remaining sound data if it doesn't all fit into ST RAM.
  129. While playing, this data is then copied into ST RAM by blocks till the end
  130. of the animation. A copy of 1.5Mb takes 0.5sec. You may get some small
  131. gaps in the sound while it is being copied across.
  132.  
  133.  
  134.         R U N N I N G   T H E   P R O G R A M
  135.         *************************************
  136.  
  137. The files:
  138. ¨¨¨¨¨¨¨¨¨¨
  139.     M_PLAYER.PRG    ; the program
  140.     M_PLAYER.RSC    ; the dialogs (put into the same folder!)
  141.     MPLYR_FR.DOC    ; french documentation
  142.     MPLYR_EN.DOC    ; english documentation (Thanks Dave!)
  143.     MPLYR_GE.DOC    ; german documentation (Thanks Martin)
  144.     MP_ICONS.RSC    ; 4 icons made by Julien Chauveau for your desktop.
  145.     SLIDSHOW.DOC    ; batch files and MOV-Maker
  146.     HISTORIC.TXT    ; the history
  147.     COMMANDS.DOC    ; the options of the command line (TTP mode)
  148.  
  149. Running:
  150. ¨¨¨¨¨¨¨¨
  151.     You can double-click on it (you'll get the fileselector), here
  152. you can specify the filename or a mask (*.MOV).
  153.     You can also drag and drop one animation on it (the fileselector
  154. will be skipped).
  155.  
  156.     First dialog:
  157.  
  158.     1) The first part indicates the name and the type of file
  159.     detected.
  160.  
  161.     2) The green box gives informations about the video data (size,
  162. number of frames, compression) and if the compression is supported or
  163. not. If you have selected a sound-only file, you will get a message
  164. saying 'No graphics found'. This dialogue also indicates whether the
  165. video format is supported or not. If it is not supported, M_PLAYER
  166. will still play any sound data that may be present, but there will be
  167. no video.
  168.  
  169.     3) The orange box gives information about the sound (frequency,
  170. resolution, channels). Some frequencies and resolutions (4bits) are not
  171. supported. Sometimes you'll get the 'Supported' message but you get no
  172. sound: this means that the system has run out of memory. If there is no
  173. sound data present, You will get the message 'No Sound'. The file will
  174. still play but it will be in video only.
  175.  
  176.     4) The 'Play Sound' box selects/deselects sound playing (subject to
  177. sound data being present of course!).
  178.  
  179.     5) The 'Synchronize' box selects/deselects synchronization between
  180. sound and video (subject to sound and video data being present of
  181. course!).
  182.  
  183.     4b) 'Max speed' is a switch for FLx/SEQ to display the frames
  184. without any delay between them.
  185.  
  186.     5b) FLx: else (when max speed isn't set), you can select here the
  187. correct speed in frames per second.
  188.  
  189.     6) 'Informations...' gives informations.
  190.  
  191.     7) 'Go!' starts the animation. If sound data needs loading, playback
  192. will be delayed and you will see a dialogue box saying 'Loading
  193. sound...'.
  194.     If "(Alt) Go!" is available and that you use it, you'll enter the
  195. Step by step mode (see below).
  196.     With a BATCH file, 'Alt' key toggles between slide-show and
  197. create-movie.
  198.  
  199.     8) 'Cancel' does just that.
  200.  
  201. Statistics:
  202. ¨¨¨¨¨¨¨¨¨¨¨
  203.     At the end of an animation, a BOX with statistics is displayed, if
  204. the movie was only a sound file, this box is skipped:
  205.     * Total frames:    the number of video frames in the file.
  206.     * Frames displayed: the number of video frames actually displayed
  207. (100% without sound synchronisation, sometimes less with synchronisation
  208. because some of them have been skipped to 'follow' the sound data).
  209.     * Total time: the duration of the animation in seconds.
  210.     * Average: number of frames actually displayed every second.
  211.  
  212. Program ending:
  213. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  214.     If you've started with a fileselector, you'll be back in it after
  215. every animation. You must choose 'cancel' from the selector to quit.
  216. With drag and drop, you'll return automatically to the desktop.
  217.  
  218. How to stop an animation?
  219. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  220.     With the 'Control' key.
  221.  
  222.  
  223. Step by Step mode
  224. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  225.     ** Fileselector **
  226.  
  227.     You must specify the path where the TGA files will be saved, their
  228. default name is:
  229.     FRM00001.TGA (up to 99999 different files!)
  230.     You can change the first 3 characters by entering them into the
  231. 'File name' field of the fileselector. They will replace 'FRM'.
  232.  
  233.     ** Mini Menu **
  234.  
  235.     (S) save: saves the current frame
  236.     (A) all : saves all the frames (starting at the current one), you
  237.     can stop that with the Control key.
  238.         (a bell during saving indicates a write error, maybe Disk
  239.         full or else)
  240.     (Q) quit: quits
  241.     Esc    : same as above
  242.     (R) run    : displays automatically the frames until you use the
  243.     Control Key.
  244.     Other   : any other key advances one step ahead into the file.
  245.  
  246.     ** TGA Files **
  247.  
  248.     format: TGA 2 uncompressed, header is 18 bytes long:
  249.  
  250.     Long $00000200
  251.     Long $00000000
  252.     Long $00000000
  253.     Word width    (Intel)
  254.     Word height    (idem)
  255.     Word $1820
  256.     Then the pixels line by line with 3 bytes per pixel:
  257.     Blue/Green/Red.
  258.  
  259.  
  260.         S O M E   Q U E S T I O N S
  261.         ***************************
  262.  
  263. How was it done?
  264. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  265.     Dieter Fiebelkorn sent me his own work (in 'C' language) that
  266. could display CVID frames from an AVI or a MOV file. I made the
  267. translation into ASM, then I added the (little) GEM interface, the DMA
  268. sound, the synchronisation, the NOVA and Crazy Dots 2 support.
  269.  
  270.     As version 1.1, the AVI file parsing has been totally re-written
  271. to use the 'idx1' section and get the sound more easily.
  272.  
  273.     With version 1.2, the FLI/FLC format is supported and the
  274. synchronisation has been improved with some files (less frames skipped).
  275.  
  276.     Version 1.22 allows all formats to be played with 256 colors (with a
  277. graphic card). That was only possible with CVID before.
  278.  
  279.     I used ASSEMBLE (Brainstorm), the fastest and the best assembler
  280. I've ever seen.
  281.  
  282. The size of the program
  283. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  284.     Dieter's version builds a very large table (512k, to convert
  285. CVID colors into 16 bits) each time it is launched. Because this needs
  286. floating point routines (if no 68882 is present), I prefered to
  287. include this table directly onto the disk (versions 1.00 to 1.20).
  288.     But, I found that 530Kb was a bit big on the disk and into
  289. memory (for instance, a CRAM16 movie doesn't need it). So I took back
  290. Dieter's method and now this table is built in memory only if
  291. required, and so does not need a coprocessor. That's what the delay is
  292. between the main dialog and 'Loading sound...'.
  293.  
  294.  
  295. Frequencies
  296. ¨¨¨¨¨¨¨¨¨¨¨
  297.     MAC or PC files have mainly use one of 3 frequencies: 11kHz, 22kHz
  298. or 44kHz. When M_PLAYER loads the sound, it makes a frequency conversion
  299. to get 12,5kHz or 25kHz or 50kHz which are the DMA frequencies (each 8
  300. bytes per block, it repeats the last byte, so getting 9 bytes and that's
  301. all).
  302.  
  303. Bugs?
  304. ¨¨¨¨¨
  305.     Yes, possibly! My program crashes when:
  306.     - Metados works now (version 2.70)
  307.     - The animation is larger than the screen (you should try, maybe
  308. it won't crash for you), then use a virtual screen.
  309.     - Turbo Veille bug fixed (V1.36).
  310.     - Extendos bug is fixed (V1.36, thanks to Yu-Ou Wang)
  311.     - Freedom bug fixed (V2.05)
  312.     - FPATCH2.PRG can correct some sound problems.
  313.  
  314.     Thanks to:
  315.  
  316.     - Pascal Ricard (Pierrevert, France, Falcon 4Mo)
  317.     - Julien Chauveau (Méron, France, Falcon 4Mo)
  318.     - Hervé Piedvache (Paris, Falcon 4Mo)
  319.     - Dave Brook (Stony Sratford, England, TT 20Mo + Crazy Dots 2)
  320.     - Magnus Kollberg (Sweden, Falcon 4Mo)
  321.     - Martin Rothaemel (Germany, TT 8Mo + NOVA)
  322.     - Yu-Ou Wang (Paris, Falcon 40MHz)
  323.     - Oliver Skelton (South Croydon, GB, Falcon + BlowUp Hard 1)
  324.     - Jacobo Morro (Spain, Falcon)
  325.     - Rémi Vanel (France, Falcon)
  326.  
  327.  
  328.  
  329.             S O M E   T E S T S
  330.             *******************
  331.  
  332.     Here is my system:
  333.     TT 32MHz, 2 Mo ST RAM, 16 Mo TT RAM, NOVA 32768 colors, CD-ROMx2
  334. 68030-cache is ON and the program runs into TT RAM.
  335.     My screen mode is 640x480x32768.
  336.  
  337.  
  338.     Most of those animations are taken from CDs sold with French
  339. magazines, so If you're not French you won't be able to find them
  340. easily. But these tests will give you an idea of the possible speed.
  341.  
  342.     - The AVI tests were done before I added the sound. So the results
  343. are without synchronisation so they are displayed at maximum speed.
  344. With synchronisation, I get a minimum of 90% of frames displayed.
  345.  
  346.  
  347. CD Atari Compendium
  348.  
  349.     Path: FILES\MISC\JAGUAR\AVI, size 160x120.
  350.  
  351.        file        | total time    | frames/s
  352.        ----------------+---------------+-------------------
  353.        DEFENDER    | 9,6        | 26.5
  354.        HIGHLAND    | 24.6        | 25.9
  355.        IRON2        | 16.9        | 25.9
  356.        PENGUINS    | 5.9        | 25.4
  357.        PITFALL        | 12.5        | 26.2
  358.        RAYMAN        | 11.8        | 25.8
  359.        ULTRA        | 9.9        | 25.4
  360.        WMCJ        | 9.8        | 25.8
  361.        ----------------+---------------+-------------------
  362.  
  363. CD Loisirs CD n15
  364.  
  365.     MYTHES\VIDATA, size 368x276
  366.  
  367.     AVLEVFR        | 70.2        | 15.0
  368.     ----------------+---------------+-------------------
  369.  
  370. PC Fun CD FUN n17
  371.  
  372.     root, size 320x240
  373.  
  374.     PCF17        | 6        | 13.9
  375.     ----------------+---------------+-------------------
  376.  
  377.     - the MOV files are synchronised, sometimes frames must be skipped
  378.     (because the display is too slow). The size is always 320x240.
  379.  
  380. PC Fun CD FUN n17
  381.  
  382.     path GUIGNOLS
  383.  
  384.     file        | frames displayed/total| frames/s
  385.     ----------------+-----------------------+-------------------
  386.     JOHNNY        | 78/111        | 10.6 (good)
  387.     TAPIE        | 59/87            | 10.1 ( " )
  388.     VILLIERS    | 18/42            |  6.5 (sometimes frozen)
  389.     ----------------+-----------------------+-------------------
  390.  
  391. GEN 4 CD n°87
  392. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  393.     path CLUBEURO\VIDEOS
  394.  
  395.     DEFI        | 277/279        | 6.8 (good)
  396.     ----------------+-----------------------+-------------------
  397.  
  398.     path VIDEO
  399.  
  400.     G4NEWS        | 4851/5376 (6 minutes!)| 13.5 (good)
  401.     G4TDN3D        | 1523/3060        |  7.4 ( " )
  402.     G4RSCI        | 3462/3844        | 13.5 ( " )
  403.     G4TBM        | 1561/2136        | 10.9 ( " )
  404.     1G4RPAN        | 1905/2358        | 11.8 ( " )
  405.     G4INTRO        | 246/496        |  7.5 (good)
  406.     G4PCON        | 291/577        |  7.5 (good)
  407.  
  408.  
  409.     Well, this is the END...
  410.  
  411. ******************************
  412.     TT + NOVA users
  413. ******************************
  414.     I made 2 softs for you:
  415.     - Color TT that gives you color-icons on the desk (without any
  416.     alternative desktop as Gemini or other, this saves RAM!). Doesn't
  417.     work well with NVDI.
  418.     - VIDINOVA.PRG that drives the VIDI ST 12 video card in
  419.     640x480x32768. Images can be: 320x240x16 grey, 320x240xcolor or
  420.     320x480xcolor. Saves IMG files (16 grey) or TGA files (color).
  421.     The original soft from ROMBO worked only in ST low res! Should
  422.     work too with Crazy Dots2.
  423.  
  424.     I give those 2 softs (for 1UKP each) with every registration of
  425.     M_PLAYER, (1UKP -> 7,5Franc -> 1,5$ -> 2DM).
  426.     As they don't cost much, there won't be any support on them.
  427.  
  428. ********************
  429. Res-change on Falcon
  430. ********************
  431.  
  432.     The programs, if not lauched in True Color, switches to TC to
  433. display an animation. I give no warranty about the safety of my routine, I
  434. won't pay for any damage caused to your monitor (the routine has been
  435. succesfully tested from 16 and 256 color modes, it didn't work from
  436. monochrome or 4 color modes).
  437.  
  438.     The only way to avoid this switch is to launch M_PLAYER in TC from
  439. the desktop.
  440.  
  441.     If your monitor makes a 'clunk' at every res-change, you should be
  442. careful, if it doesn't and seems to support it, well, do what you want.
  443.  
  444. ***********************
  445. TT without graphic card
  446. ***********************
  447.  
  448.     The displays switches to 320x480x256 to play the animations. If
  449. the height allows it, the animation is doubled to correct the aspect
  450. ratio, if the width is greater than 320 pixels, the image is reduced to
  451. its half: finaly, every animation up to 640x480 is accepted.
  452.     Limits are those of the NOVA 256 colors mode:
  453.     - 16bits or TC animations are replayed in grey
  454.     - other animations are replayed in colors (<=256)
  455.     - no step by step mode
  456.  
  457.     The display is slower than with a graphic card, because instead of
  458. writting directly into the video RAM, the program uses a buffer witch is
  459. re-encoded bit by bit into the video RAM.